QuickTime 4 Reference

Interesting Times Flags

The interestingTimeFlags parameter for the interesting time functions (GetMovieNextInterestingTime , GetTrackNexttInterestingTime , and GetMediaNextInterestingTime ) specifies a set of bit flags that specify search criteria. Normally, you use one of the interesting time functions to step forward to the next frame.

These functions work well for most media types, including video and text. However, because QuickTime stores an entire MPEG stream as a single sample, stepping to the next sample skips to the end of the sequence. To solve this problem, QuickTime 2.1 introduced a new flag for the interesting time calls: nextTimeStep . This flag returns the time of the next frame, even if there are multiple frames per sample, for all media types including video, text, and MPEG. Applications that implement single stepping capabilities should always use this flag instead of nextTimeMediaSample .



 
enum {

    nextTimeStep    = 1 << 4

};

Flag description

nextTimeStep: Searches for the next frame in the movie's media. Set this flag to 1 to step to the next frame.